home *** CD-ROM | disk | FTP | other *** search
/ EnigmA Amiga Run 1995 November / EnigmA AMIGA RUN 02 (1995)(G.R. Edizioni)(IT)[!][issue 1995-11][Skylink CD].iso / earcd / program / misc / vectoram.lha / Vectorama / Vectorama.doc < prev    next >
Text File  |  1995-08-19  |  11KB  |  290 lines
  1. *****************************************
  2. *      Vectorama    V 1.3        *
  3. *    Written by  Troglobyte/Darkness    *
  4. *  Original by Spanish Archer/Darkness    *
  5. *   Last Version Updated  : 19/Ago/95    *
  6. *****************************************
  7.  
  8. Contents
  9. ========
  10.  
  11.  1. Introduction
  12.  2. Requirements
  13.  3. Instructions
  14.  4. Vector Data Format
  15.  5. Problems and known bugs
  16.  6. What is OriginalWare?
  17.  7. History
  18.  8. Credits
  19.  
  20.  
  21. 1. Introduction
  22. ===============
  23.  
  24. The  use  of  2D  (two  dimensions)  vectors  is very common in a lot of new
  25. productions,  mainly due to design reasons.This vectors may look very simple
  26. sometimes but the creation of this vectors aren't so easy because just a few
  27. pixels  distance can  be very important, and edit the vectors until they are
  28. perfect  can  be  really  boring (as lots of coders, graphicians and coder's
  29. slaves  will  know).To  ease  this, Spanish Archer created his own 2D vector
  30. editor, and  later I recoded  his  program  with  lots of new  options. Sure
  31. that a lot of coders did the same but I haven't seen any of them released so
  32. I  decide to release my vector editor, called Vectorama.  I worked part-time
  33. on  it during the last year, testing, adding and improving things.During the
  34. last  days  I  worked to make it more intuitive for the user, maybe you will
  35. find  it  hard to use at first, but with a little of practice you will fully
  36. understand  it;  just  use it to  create  your 2D vectors work and save your 
  37. work to use it in your own productions.
  38.  
  39. The  resulting  vector  data  file  could  be used only by coders in his own
  40. programs but everybody can use Vectorama to create vectors for the coder.
  41.  
  42. The  only  limitation  of  Vectorama  are  the 2D, because you can use it to
  43. create or edit vectors, lines and dots.  Some features of Vectorama that you
  44. will  find useful is the possibility to load IFF files and a Genlock mode to
  45. draw  over them, the data is saved in `my standard' vector format, it's 100%
  46. coded in assembly and have lots of options to draw and edit vectors.
  47.  
  48. You  will  find  funnier and easier to use it than read the instructions, so
  49. look at the keys and give it a try right now.
  50.  
  51.  
  52. 2. Requirements
  53. ===============
  54.  
  55. The  only  real requirement is the `ReqTools.library' by Nico Francois (yes,
  56. Nico is his first name) that is used to save and load files.
  57.  
  58. There are two versions of ReqTools.library, one for KickStart 2.0+ and other
  59. for  KickStart  1.x  users.Remember to copy the version you will need in the
  60. LIBS: directory of your boot disk.
  61.  
  62. This  program  must  work  in  every  AGA/nonAGA Amiga with at least 512K of
  63. memory.  (So this must include every Amiga)
  64.  
  65.  
  66. 3. Instructions
  67. ===============
  68.  
  69. Vectorama is mainly controlled via Mouse and Keyboard,  the fire button of a
  70. Joystick conected in port 2 is optional.
  71.  
  72. At  the  botton  of the screen you have a panel with all the info about your
  73. current status.There are some icons indicating the selected options and some
  74. text and numbers with additional data.
  75. Remember  that  the  Panel  is  only to provide information and the Mouse to
  76. operate  in  the  main  screen,  so you can't Select/Activate nothing in the
  77. Panel with the Mouse.
  78.  
  79. In the main screen you can see your current vector figures. You can move the
  80. screen with the cursor keys, so your vectors aren't limited by screen size.
  81.  
  82. The controls -[key],(Mouse),{JoyStick}- are :
  83.  
  84. [ESC]= Exit  Vectorama        (Confirm with LEFT Mouse, abort with RIGHT)
  85. [F1] = Clear Vector Data    (Confirm with LEFT Mouse, abort with RIGHT)
  86. [F5] = Load  Vector Data     (Vectorama.VM data file)
  87. [F6] = Save  Vector Data     (Vectorama.VM data file)
  88.  (While the current Poly have only 1 or 2 points the save option is disabled)
  89.  
  90. [HELP]= Info Panel         (On/Off)
  91. [F10] = Select between Filled vectors/Line vectors/Single Lines/Dots
  92. [F9]  = Invert Fill
  93. [F8]  = Closed/Open Polygons.
  94. [F7]  = Line to Pointer        (On/Off)
  95.  
  96. [BackSpace] = Select MODE : DRAW / EDIT / MOVE
  97.  DRAW:    (LEFT)      = Draw New Point
  98.      (RIGHT)     = Delete Last Point 
  99.     [Right ALT] = Start New Polygon
  100.      {FIRE}      = Start New Polygon
  101.      [Left SHIFT]  = Fix X axis  [Right SHIFT]=Fix Y axis (DPaint style)
  102.     [CURSOR Keys] = Move screen.
  103.  EDIT:    (LEFT)       = Edit Mode On  :
  104.                 (LEFT) = Select  new coords.
  105.                 (RIGHT)= Restore old coords.
  106.      (RIGHT)      = Select Next Point   
  107.     [Left AMIGA] = Select Next Point
  108.     [Left ALT]   = Select Previous Point
  109.      {FIRE}       = Select Previous Point
  110.      [Left SHIFT]  = Fix X axis  [Right SHIFT]=Fix Y axis (DPaint style)
  111.     [Cursor Keys] = Move screen.
  112.  MOVE:    [Cursor Keys] = Move vector points coords.
  113.  
  114. IFF commands : use a IFF picture as background
  115. [F4]  = Load  IFF picture
  116. [CTRL]= IFF On/off
  117. [F2]  = Darker  IFF colors
  118. [F3]  = Lighter IFF colors
  119. [DEL] = Swap Mouse Colors
  120.  
  121. Vector Light Table commands : use current vector as background 
  122. [TAB] = Light Table On/Off
  123. [~]   = Clear Light Table    (Confirm with LEFT Mouse, abort with RIGHT)
  124.     (The `~' key is under the `ESC' key)
  125.  
  126. [CAPS LOCK] = Genlock On/Off
  127.  
  128. A printed copy of this keys would be useful to use Vectorama.
  129.  
  130.  
  131. 4. Vector Data Format
  132. =====================
  133.  
  134. The  format  used to save the vectors is a very standar vector format, maybe
  135. it  will be different to your own format, but it will be very easy to make a
  136. converter  from my format to your own vector format in Basic, C, Amos or any
  137. language  you  like.In  the  last  resort you can contact me to support your
  138. vector format in future releases.
  139.  
  140. All the data is saved in WORD size (2 bytes) as a binary file (use IncBin).
  141.  
  142. When saving the last polygon will be automatically closed too.
  143.  
  144. The origin is (0,0), so you never will find negative values as coordinates X
  145. and  Y  of  a point, if you use negative values, simply substract or use the
  146. MOVE mode (but this isn't recommended)
  147.  
  148. The  VM  suffix and a number is added at the end of the name when saving the
  149. vector data, just to remenber you that it is a VectoraMa data file.
  150.  
  151. *  Format used to Save/Load the vectors :
  152. *  VM = Vector Data (Coords + Polys)
  153.  
  154.      dc.w    N.Points    ; Number of Points (of all Polygons)
  155.     dc.w    Point0x,Point0y,Point1x,Point1y.....
  156.         (Coords of all the points of every Polygon)
  157.         
  158.     dc.w    N.Polygons    ; Number of Polygons
  159.     dc.w    N.Points of Polygon1,Point0,Point1,....,Point4,Point0
  160.         (Every Polygon finish with his first point)
  161.     dc.w    N.Points of Polygon2,Point5,Point6,....,Point9,Point5
  162.     dc.w    ......Rest of Poligons
  163.     dc.w    0        ; End of Vector
  164.  
  165.  
  166. Example : 1 cube (4 points) and 1 triangle (3 points)
  167.     dc.w    7        ; 4+3=7 Points
  168.     dc.w    0,0,0,10,10,10,10,0    ;Coords X,Y of the cube
  169.     dc.w    50,50,40,60,60,40    ;Coords X,Y of the Triangle
  170.  
  171.     dc.w    2        ; 1 cube+1 triangle = 2 Polygons
  172.     dc.w    4,0,1,2,3,0    ; Cube    : 4 points and which 4 points.
  173.     dc.w    3,4,5,6,4    ; Triangle: 3 points and which 3 points.
  174.     dc.w    0        ; End of Data    
  175.  
  176.  
  177. 5. Problems and known bugs
  178. ==========================
  179.  
  180. The `SAVE Vector data' only works when all the polys are complete polys(i.e.
  181. all the polys have at least 3 points).If the last poly have less of 3 points
  182. the  data  won't  be  saved.If your current poly have only 1 or 2 points the
  183. save file requester won't appear and you can't save your data.
  184.  
  185. Vectorama  isn't  a 100% system friendly program so I recommend don't use it
  186. while  running other Amiga programs with important unsaved data to avoid any
  187. data loss of importance in case of any problem.
  188.  
  189. The  Genlock  mode  isn't  real,  it  works with Genlocks but using the LACE
  190. mode.If  you  have  a  Genlock  and  you  want the real Genlock version just
  191. contact me and I will send you it.
  192.  
  193. You  can only load IFF pictures of 320x256 pixels (or 320xY, with Y<256) and
  194. the  maximun  number  of  colors  is  32,  if  you want to use other type of
  195. picture, reduce the size and number of colors with your paint program.
  196.  
  197. I  recommend  saving  to  RAM:   or  RAD:  because sometimes floppy and hard
  198. drives  aren't  validated until you exit VectoRAMa.To avoid this problem use
  199. RAM: and RAD: drives, and at exit copy the VM data to your drive.
  200.  
  201. If  you  load a file that isn't a real Vectorama.VM file a GURU could be the
  202. result, so don't try to load `Hired Guns' as a VM file.
  203.  
  204. This  version  was  finished  a  few  hours before it was released, I did an
  205. intensive  testing  to remove all bugs, but be sure there are some very well
  206. hidden bugs waiting inside.If you find any of them or any other problem send
  207. me a detailed report of the error and your machine, and I will try to fix it
  208. and send you the new version.
  209.  
  210.  
  211. 6. What is OriginalWare ?
  212. =========================
  213.  
  214. This  utility  is  OriginalWare.That means if you like this program you must
  215. buy an original Amiga program or game or send the money to the author of any
  216. ShareWare(if you don't send it already) program or game you are using often.
  217.  
  218. There  are lots  of  great  Amiga software like  `DiskMaster', `Hired Guns', 
  219. `Syndicate',  `Goal',  `Cannon  Fodder',  `Pinball  Fantasies',  `Stardust',
  220. `Elfmania'  and  a lot more that you won't never regret to spend your money.
  221.  
  222. If you do this you support Amiga and if you support AMIGA you support US.
  223.  
  224. For  more information or suggestions about the OriginalWare concept, contact
  225. me, please.
  226.  
  227. Support OriginalWare software and you will get more and better software.
  228.  
  229.  
  230. 7. History
  231. ==========
  232.  
  233. Version 1.0 (23-Jul-94) :
  234.  
  235.   - First released version.Released at The Southern Party 2 in Spain.
  236.  
  237. Version 1.1 (26-Jul-94) :
  238.  
  239.  - More command Keys added :
  240.     In DRAW Mode :
  241.         [Right ALT]  = Start New Polygon
  242.     In EDIT Mode :
  243.         [Left ALT]   = Select Previous Point
  244.         [Left AMIGA] = Select Next Point
  245.  - Bug fixed : a nasty (Guru Meditation) error when deleting points.
  246.  
  247. Version 1.2 (23-Nov-94) :
  248.  
  249.   - Single Lines Mode added to the [F10] key.
  250.   - Vector Light Table added : copy current vector to the background
  251.       [TAB] = Light Table On/Off
  252.       [~]   = Clear Light Table 
  253.  
  254. Version 1.3 (19-Ago-95) :
  255.  
  256.   - Bug fixed : sometimes coords numbers looked corrupted.
  257.  
  258.  
  259. 8. Credits
  260. ==========
  261.  
  262. `Vectorama' was coded by Troglobyte / Darkness, based in the program
  263. `Vectorizador', original  idea and code by Spanish Archer / Darkness.
  264.  
  265. Send me JOB offers, BUGS, comments, improvements, ideas, suggestions, disks,
  266. mags,  advices,  complains,  nice PD stuff (like Demos, Games or Utilities),
  267. and any kind of production where Vectorama was used :
  268.  
  269.             M. Martin Vivaldi
  270.              Av. America 60
  271.               Madrid 28028
  272.                  SPAIN
  273.  
  274. Or NetMail me at :
  275.  
  276.  Internet : bitabit@servicom.es        (Faster and safer)
  277.  
  278.  FidoNet  : 2:341/28.55        Manuel Martin
  279.  
  280.  AmigaNet : 39:192/2.55        Manuel Martin
  281.  
  282.  To Magazines :
  283. You  can  give  away  Vectorama v1.3 on your coverdisk, but please send me a
  284. copy of the magazine.
  285.  
  286.                                         Amiga, keep the dream alive.
  287.  
  288.  
  289.     
  290.